package jsu.ljy.lostandfind.service;

import java.util.List;

import jsu.ljy.lostandfind.model.User;

/**
 * 用户服务接口
 * 
 * <p>定义了用户相关的业务逻辑操作接口，包括用户注册、登录、信息查询等功能。</p>
 * 
 * @author 罗嘉毅
 * @version 1.0
 * @since 2024-03-21
 */
public interface UserService {
    /**
     * 用户登录
     * 
     * @param username 用户名
     * @param password 密码
     * @return 登录成功返回用户信息，失败返回null
     * @throws IllegalArgumentException 当用户名或密码为空时抛出
     */
    User login(String username, String password);

    /**
     * 用户注册
     * 
     * @param user 用户信息
     * @throws IllegalArgumentException 当用户信息不完整或用户名已存在时抛出
     */
    void register(User user);

    /**
     * 更新用户信息
     * @param user 用户信息
     */
    void updateUser(User user);

    /**
     * 删除用户
     * @param id 用户ID
     */
    void deleteUser(Long id);

    /**
     * 根据ID查询用户
     * 
     * @param id 用户ID
     * @return 用户信息，不存在时返回null
     * @throws IllegalArgumentException 当ID为null时抛出
     */
    User getUserById(Long id);

    /**
     * 根据用户名查询用户
     * @param username 用户名
     * @return 用户信息
     */
    User getUserByUsername(String username);

    /**
     * 查询所有用户
     * @return 用户列表
     */
    List<User> getAllUsers();
} 